BROWSALL.PGM enables the user to read consecutive files in a directory, moving up and down the list of files with one-key commands. The program includes options to search for directory entries by typing the first few letters in a filename or, while reading, to exit the program and edit a text file or XPL program.
A tree of directories may also be displayed and subdirectories chosen by hitting the Return or Execute keys. The drive may also be changed from the Tree option.
Included in this set of programs are BROWSALL.PGM, which will run on versions of XyWrite III Plus beginning with 3.51; BROWSALL.354, a version which runs only under XyWrite 3.54 and later; and BROWSALL.INT, a program that allows convenient changes in the two high savegets used by the program (100 and 101 as distributed) and in the list of filename extensions that prevent editing binary files that could be damaged by the editor. All these programs should also run under Nota Bene.
BROWSALL is executed most conveniently from an @ or & saveget but may also be invoked from the CM line with "run." After execution, the CM line shows filespecs from the last directory created with BROWSALL during the current editing session, or the string on the CM line when the program was executed, or the parameters passed if the program was invoked with a "run" command.
New filespecs, with path and wildcards, may be entered on the CM line. BROWSALL allows editing of the CM line, using backspace, delete and cursor commands. The BeginCommand function -- BC, usually F5 in XyWrite -- will clear the CM line if desired. The program can interpret a normal directory command left on the CM line when BROWSALL is executed (for example, "dir d:\"), but all that is needed once BROWSALL is started are the actual directory specifications. In fact, BROWSALL doesn't allow entry of spaces on the CM line, so the directory command cannot be entered during the program's execution.
If the directory specification includes wildcards (* or ?), the program uses that specification exactly as provided, allowing the building of a selective directory of files in the default directory without specifying a full path. If no wildcards are present, the program checks for the presence of \ whether or not the string "dir" began the parameter passed to the program. A \ is not added if a drive is specified, allowing the building of a default directory on a drive without specifying a full path. BROWSALL cannot tell whether additional \ are needed to separate subdirectory names. If a directory cannot be found for the specifications entered, the program returns to the "Dir name?" prompt.
BROWSALL needs a normal return or XC (usually F9 in XyWrite) to execute the directory command. It will not work if additional commands are loaded on those keys, e.g., for a stacking program. In such cases, a normal return or XC may often be obtained in a shifted state of those keys; check the KBD file you have created if using such programs.
Enter / to begin searching a directory for filenames. Then type the first few letters of the filename and cursor jumps to files fitting the specifications. Use a period when adding the extension to a filename (spaces are not accepted). Type / once for a new search beginning with the last directory entry found or type / twice to move to the top of the directory for a new search of the complete directory. XC or return ends any search.
Directory searching works most effectively when XyWrite is told to list files in standard alphabetic order. BROWSALL resets the directory default with the command "BC dsort f,eXC ". If the user desires, this command may be deleted with no greater loss than some inconvenience in the search function.
All cursor commands are available when a file is displayed, including PgDn/PgUp, NextWd/PvsWd, etc. Text can be expanded to show labels with CM function (usually Ctl-F9 in XyWrite). <E>dit exits program for normal editing of displayed file. <K>allPgm edits program file, beginning in expanded mode. <N>ext and <P>revious allow display of successive files in directory. <D>ir returns to directory. <Q>uit aborts the displayed file and empties savegets 100 and 101.
BROWSALL does not accept <E>dit and <K>allPgm commands if the displayed file has the following extensions. COM, EXE, ARC, ZIP, PAK, LZH, ZOO. All such files are binary and would be damaged if loaded into the editor and stored. Other extensions can be excluded by adding to the series of extensions in lbSv and expanding the testing in the IF statement following sx30,va$fp -- contact the author for help if you do not wish to attempt this.
If not ended with <Q>uit, the program will place the former directory specification on the CM line and, if that specification is accepted, return to the same line in the directory.
BROWSALL uses permanent savegets 100 and 101, which may be changed to other savegets over 100 (which remain throughout each XyWrite session) by editing each instance of those numbers in the program.
Run BROWSALL.INT to change a fresh copy of either BROWSALL version. It prompts for changes to SGTs 100 and 101 and offers a chance to add to the list of file extensions that the program checks to see if it should not allow editing of files so identified. Hit ESC to skip changing SGTs 100 or 101. Hit XC or Return to end entry of the list of extensions, and ESC when there are no more extensions to add. The code necessary to handle an expanding list of extensions is written for XyWrite versions 3.54 and higher, so BROWSALL.INT will only change the numbering of the two high savegets in BROWSALL.PGM.
Only one window is required. Please advise the author of any difficulties.
-- Jim Franklin, CIS 72136,224, BIX jimfranklin
[Revised 2/11/91 to improve parsing of directory names and to add installation routines.]
[Revised 2/18/91 to add file searching to directory functions and to fix handling of blank entries in installation routines.]
[Revised 2/23/91 to add navigation of tree directory and drives.]
